Skip to content

feat: add agent-onboarding skill#30

Open
lukas-bekr wants to merge 6 commits intoapify:mainfrom
lukas-bekr:add-agent-onboarding-skill
Open

feat: add agent-onboarding skill#30
lukas-bekr wants to merge 6 commits intoapify:mainfrom
lukas-bekr:add-agent-onboarding-skill

Conversation

@lukas-bekr
Copy link
Copy Markdown
Contributor

@lukas-bekr lukas-bekr commented Mar 25, 2026

Summary

  • Adds apify-agent-onboarding skill - a disambiguation layer that routes agents to the correct Apify installation path (MCP server, Agent Skills + CLI, or API client)
  • Adds Quickstart section to README highlighting the onboarding skill as the entry point
  • Registers skill in marketplace.json

Why

Blank-slate AI agents that encounter "install Apify" currently have no way of knowing what's the correct onboarding path and might install CLI or SDK when MCP is the right entry point. This skill detects intent from the user (or agent) first and routes accordingly.

Three independent paths:

  • Path A: MCP server - for research (docs), discovery (search store) and ad-hoc simple scraping of smaller datasets
  • Path B: Agent Skills + CLI - for multi-step data pi workflows (ultimate-scraper) and Actor development (actor-development, actorization, generate-output-schema)
  • Path C: API integration - for wiring apify-client to existing JS/Python apps

The skill is written from the agent's perspective ("direct your user to...") rather than human-facing instructions.

Context

  • Complementary to docs PR in apify/apify-docs
  • part of apify.com/.well-know/agent-skills/... implementation

lukas-bekr and others added 3 commits March 30, 2026 09:24
The generate_agents.py script doesn't parse YAML block scalars (>).
Switched to single-line description matching the format of other skills.
Regenerated AGENTS.md via the script to match expected output exactly.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@vystrcild vystrcild self-requested a review March 30, 2026 07:45
@lukas-bekr
Copy link
Copy Markdown
Contributor Author

After discussion with @vystrcild let's not merge this into this repo but rather use it for /.well-known/ RFC discovery

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants